package com.openideals.android.search;


/**
 * An interface for classes that wish to provide access for searching media repositories 
 * with XSPF or RSS formatted search results
 *
 */
public interface MediaSearchService {

	
	/*
	 * A unique key for the service
	 */
	public String getServiceId ();
	
	/*
	 * Taking a search keyword and result bounds, return a generated URL that will retrieve a relevant result set
	 */
	public String getSearchUrl (String keyword, int start, int max);
	
	/*
	 * A list of view labels and their corresponding access URLs
	 */
	public String[][] getDefaultViews ();
	
	/*
	 * Taking a view label retrieved from getDefaultViews(), return the appropriate URL for retrieval
	 */
	public String getViewUrl (String viewLabel);
	
	/*
	 * indicate whether this service returns results in XSPF or RSS format
	 */
	public String getFeedFormat ();
	
	public final static String FORMAT_RSS = "rss";
	public final static String FORMAT_XSPF = "xspf";
	
	
}
